home *** CD-ROM | disk | FTP | other *** search
/ Aminet 37 / Aminet 37 (2000)(Schatztruhe)[!][Jun 2000].iso / Aminet / game / patch / VGP-upgrIII.lha / Cars-TrackEditor / Conv3do / Conv3do.readme < prev    next >
Text File  |  2000-02-07  |  11KB  |  150 lines
  1.  
  2.         The "Conv3do" converter utility can be used to build .3do object files, ie the files that
  3. describe 3d objects in the VGP 3d engine. Every "object" you see in the virtual universe of VGP - 
  4. cars, buildings, tracks, trees, etc. - has a .3do file associated to it that describes its shape,
  5. colors, textures, etc., and this utility lets you design your own "objects". Its main purpouse is to
  6. let you design your own custom car objects, but because .3do files control every visual aspect of the
  7. VGP 3d engine, it can be used to design new tracks too (see the "TrackDesigner.readme" file).
  8.  
  9.         SYNOPSIS
  10.         
  11. Conv3do <inputfile.geo> <outputfile.3do> <b|a>
  12.  
  13. <inputfile.geo> is a standard, ASCII "3DG1" object file generated by Aegis Modeler3d when you save an
  14. object "as text".
  15. <outputfile.3do> is the name of the .3do file you want to create
  16. the last option selects whether do you want Conv3do to use absolute coordinate for the object "center"
  17. (<a> option) or calculate the "center" from points' position (<b> option - see later in this file)
  18.  
  19.         If both inputfile and outputfile have a two digit number before the file name extension
  20. ("MyNewCar01.geo" and "Car01.3do"), Conv3do will convert the first file and then it will search for
  21. "MyNewCar02.geo", "MyNewCar03.geo" and so on; this way you can convert a whole set of new objects
  22. instead of manually calling Conv3do on every one (this feature is especially useful for tracks, that
  23. are normally made of many objects).
  24.  
  25.         MODELER3D
  26.         
  27.         You should design objects using Aegis Modeler3d, whose "text" file format ("3DG1" format) is
  28. what Conv3do was designed to expect. "3DG1" files are standard ASCII files, you can load them in your
  29. preferred text editor. They simply contain a list of coordinates of the object's vertexes (in the x,
  30. y,z format), and a list of polygons - ie a series of numbers that represent how many and which
  31. vertexes build up the polygon, and the polygon's color (an integer value whose valid range is 0-4096).
  32.  
  33.         The problem here is that, as you may argue, Aegis Modeler3d was designed in the very early
  34. days of DTV, so the only attribute a polygon can have is its "color" and nothing more. Modeler3d has
  35. no support for texture mapping, light sourcing or so. Now, you will be wondering how can you design
  36. objects suitable for the VGP 3d engine (which supports these features) using Modeler3d. The answer is
  37. that you must use some strange "color" combinations in order to tell Conv3do how to build the "real"
  38. .3do file. In other words, the "color" attribute in Modeler3d controls everything, from the material
  39. the polygon is made of to the texture that must be mapped on the polygon's surface. Unfortunately,
  40. this means that you won't have the possibility of a real preview while designing the object in
  41. Modeler3d, and that the only way to see the final result is to convert the object and load it in
  42. "Preview3do", a utility included in this archive that shows you a .3do object.
  43.  
  44.         The "color" conventions are:
  45.         
  46. COLOR RANGE     MEANING
  47.  
  48. 0-31            The polygon is a flat colored one. Its color is given by multiplying by two the number,
  49.                 so 0 is black, 15 is blue (color 30 in the VGP palette) and 31 is yellow.
  50.                 
  51. 64-79           The polygon is transparent. Its primary color is given by multiplying by four the
  52.                 number minus 64; so 0-1 is black, 2-3 is gray, 4-5 is white, 6-7 is blue, 8-9 is
  53.                 green, and so on (refer to the VGP palette).
  54.                 
  55. 32-47           The polygon is a reflecting one. Its primary color is given by multiplying by four
  56.                 the number (minus 32), much the same that transparent ones. Pay attention to the fact
  57.                 that, because of many approximations in the VGP 3d engine, not every polygon
  58.                 orientation is possible; as an example, the polygon cannot reflect objects that lie
  59.                 "behind" the camera because such objects are removed early from the "displayable
  60.                 items" list (z clipping). The best way to use reflecting polygons is to put them 
  61.                 parallel to the ground (to simulate water, as an example).
  62.                 
  63. 145-175/384-511 The polygon is texture-mapped. The texture number is the color number minus 144 for
  64.                 the first 32 textures (so, as an example, 145 is the "Marlboro" texture) and then
  65.                 the color number minus 352 for the other textures (the VGP 3d engine can display
  66.                 worlds with up to 160 different textures). Because there is no way to specify u/v
  67.                 coordinates, textured polygons MUST have four vertexes and the ORDER of the vertexes
  68.                 MUST be: the first point is the top-left corner of the brush, the second is the top
  69.                 right one, the third is the bottom-right and the fourth is the bottom left. If you
  70.                 don't follow this order when creating the polygons in Modeler3d, the texture will
  71.                 appear in the wrong orientation in the best case (or won't appear at all in the
  72.                 worst).
  73.                 
  74. 128-143         The polygon is texture-mapped with a repeatable, not-oriented texture (such as grass
  75.                 or gravel); these polygons are normally used only for very large blocks in tracks.
  76.                 
  77. 192-255         The polygon is texture-mapped with a repeatable-along-the-x-axis texture; used for
  78.                 walls et al (again, large blocks in track objects).
  79.  
  80. 176-191         The polygon is a brush. VGP trees are the only brushes currently available; they
  81.                 differ from textured polygons because a brush is only rescaled (based on its Z
  82.                 position) but it doesn't change its shape if you turn around it. Only the first two
  83.                 vertexes have a meaning for a brush: the first one is the top, the second is the
  84.                 bottom. VGP uses these values to understand how "tall" is the brush and, correspondingly,
  85.                 how large should it appear.
  86.  
  87. 256             The polygon is a tyre!!! It may sound strange, but the VGP 3d engine supports "tyres"
  88.                 as native primitives (after all, it's a 3d engine designed for an F1 sim...!)
  89.                 The "polygon" must have four vertexes that give the tyre's dimension, put at a tyre's
  90.                 diameter height from the ground, and must have a strict order for VGP to know how the
  91.                 tyre is oriented. The best way to design your own tyres is probably to copy/paste the
  92.                 ones in the .geo files included in this archive, and then change their dimensions to
  93.                 your need.
  94.  
  95. 512             The polygon is an helmet. Only the first two vertexes have a meaning for an helmet,
  96.                 much in the same way they have for a brush: the first one is the top, the second is
  97.                 the bottom. Helmet colors are controlled by the "Drivers.config" file.
  98.                 VERY IMPORTANT: car objects MUST have at least one helmet "polygon" because, when
  99.                 VGP loads the "Driver.config" file, it searches for this primitive in the car
  100.                 object to set up the helmet colors accordingly. If you don't supply an helmet in
  101.                 your car object, the game COULD overwrite illegal memory locations, thus leading to
  102.                 malfunctioning, crashing or so.
  103.                 
  104. 2048+           The polygon is shaded. This is used for light-sourcing a surface. You must specify
  105.                 the primary color of the polygon (the "polygon-lit" color) and the number of "shades"
  106.                 that the polygon must have; as an example, for a red color, you may specify 54 for
  107.                 the primary, "enlighted" color, and 3 color shades. The formula is:
  108.                 2048 + (primary color number) + (shades X 64)
  109.                 So, for the above example, the right number is 2048 + 54 + (3 X 64) = 2294
  110.                 The number of shades you can specify is limited by the amount of primary colors
  111.                 available, and is normally limited to 3, 4 or 5.
  112.                 
  113.         Once you knew the "color" you must specify for the polygon, simply insert the number in the
  114. Aegis Modeler3d polygon color requester. Don't worry if Modeler3d seems to accept only numbers in
  115. the range 0-15, in fact it uses greater numbers for its own "material" info and the number you insert
  116. is stored correctly - just in case, you can use the polygon "info" menu to see the current polygon
  117. color number, and you'll see there the number you inserted.
  118.  
  119.         LIMITATIONS
  120.         
  121.         The VGP 3d engine has some limitations over polygons size, vertex number, etc., and you must
  122. take these into considerations when designing objects in Modeler3d:
  123.  
  124. -       object size shouldn't exceed 512 mts of dimensions, and it's better if their maximum radius
  125. is under 128 mts
  126. -       polygons must be made of three or four vertexes; even if the color specify a "primitive" that
  127. uses only the first two vertexes, you must supply anyway the third. Polygons made of more than four
  128. vertexes aren't supported at all by the VGP 3d engine
  129. -       polygon maximum radius must be under 128 mts, otherwise strange results could happen
  130. -       only front-facing polygons are displayed by the VGP 3d engine: if you need a front-and-back
  131. polygon you must create TWO of them
  132. -       some primitives, such as "tyres" or "brushes", can only be displayed in some orientations;
  133. textured polygons may give strange results in some "weird" orientations
  134. -       you're not required to "merge" points for maximum efficiency - Conv3do already does it
  135. -       you're free to use the "attach polygon" mode for detail polygons - it's supported by the VGP
  136. 3d engine
  137. -       if you convert the object with the <a> flag, the center of the object will be the Modeler3d
  138. environment center, ie the 0,0,0 origin point. This is good for small objects (such as cars), but
  139. for large objects, such as track blocks, which lie far from the origin, you should convert them with
  140. the <b> option that make Conv3do recalculate the center of the object and refer all the points'
  141. coordinate to the new center
  142.  
  143.         REPLACING .3do FILES
  144.         
  145.         In order to replace .3do files with your own you must copy the corresponding drawer onto your
  146. HD (in the same dir you've installed VGP into). Use the Preview3do utility to discover EXACTLY which
  147. file you want to replace. Most .3do files are located in the "Blocchi/" drawer, tracks related ones
  148. are in the corresponding "Piste/" one.
  149.  
  150.